文件模块总览 - Overview

本分类做什么

提供 目录与文件 的创建、删除、枚举、复制移动、重命名、存在性判断，以及 路径规范化 与 文本/二进制读写。与 日志 落盘路径配合时，注意 编码与换行（各读写接口见详情页）。

---

一、目录 vs 文件

操作	目录接口	文件接口
创建	CreateFolder	CreateFile
删除	DeleteFolder	DeleteFile
存在	IsDirectory、FileOrDirectoryExists	IsFile
枚举	GetFolderList	GetFileList

差异：FileOrDirectoryExists 二合一；IsFile/IsDirectory 类型明确。

---

二、复制、移动、重命名

接口	差异
CopyFile	保留源，生成副本。
MoveFile	同盘/跨盘行为以 OS 与详情页为准。
RenameFile	仅改名或同目录重命名（见详情页）。

---

三、路径

接口	用途
ToAbsolutePath	相对 → 绝对。
ToRelativePath	绝对 → 相对（需基准路径参数，见详情页）。

---

四、内容与二进制

接口	差异
ReadFileString	按 文本 读（编码见详情页）。
ReadBytesFromFile	原始字节。
WriteStringToFile	写 文本。
WriteBytesToFile	写 二进制。

选型：配置文件、JSON → String；字库 bin、图片 → Bytes。

---

五、元信息

接口	说明
GetFileSize	字节长度。
GetFileName	从路径取 文件名（不含目录）。

---

六、快速选型

需求	建议
遍历目录下所有 png	GetFileList + 后缀过滤
相对脚本目录读配置	ToAbsolutePath 再 ReadFileString
大文件分块	若插件无分块 API，需自行 ReadBytesFromFile 偏移策略（见版本是否支持）